《Day 02:產出優先思維,先定義規格再動筆》 結尾留下一句還沒兌現的承諾,心法就位不等於藍圖就位。產出優先思維與單一職責 Agent 這兩個心法已經定案,但長篇技術文章的創作過程,具體要拆成哪些角色,每個角色的職責邊界劃在哪裡,彼此之間又要如何交接工作成果,這些問題昨天都還沒有答案。今天要做的事,就是正式把這張分工藍圖攤開來。
先把今天的任務範圍界線畫清楚。今天只回答三個問題,角色是誰,每個角色的職責邊界劃在哪裡,彼此之間又是如何交接工作成果。今天不回答任何一個角色具體要怎麼設計,也不會展開系統提示詞該怎麼寫,這些留給後面的階段處理。
這個界線之所以重要,是因為接下來要揭曉的四個角色名稱,很容易讓人下意識想追問「所以規劃代理人的系統提示詞長什麼樣子」。這個好奇心可以先放著,今天要建立的是藍圖層級的共識,先確認每個角色的職責範圍彼此不重疊、不衝突,再回頭討論每個角色內部怎麼運作才有意義。順序顛倒過來,很容易在還沒釐清邊界的情況下就開始設計細節,回頭又得推翻重來。
劃分這四個角色的依據,正是《Day 02:產出優先思維,先定義規格再動筆》定案的單一職責 Agent 原則。每一個角色只承擔一種明確定義的認知任務,不得跨界承擔其他角色的職責。接下來要揭曉的四類 Agent,正是這個原則第一次被具體落實成四個實際角色的成果。它們的邊界不是隨意畫出來的,而是依照「這是不是同一種認知任務」這個判準收斂出來的結果。
在往下看之前,先回想一個熟悉的畫面。一位工程師在撰寫技術文章時,會不自覺地在多種角色之間切換,先像編輯一樣規劃結構,再像工程師一樣查證細節、動手寫程式碼,畫幾張圖幫助讀者理解,寫完之後又切換成挑剔讀者的視角重新審視一遍。這四類 Agent,正是把原本擠在同一顆腦袋裡輪流切換的多重身分,各自獨立出來成為專職角色。
規劃代理人:單一負責的認知任務,是把主題、系列定位、天數等輸入,轉化為結構化、可執行的產出規格,包含核心目標、前置概念、段落安排、結尾伏筆等規劃層級的決策。它站在編輯的位置,決定一篇文章該講什麼、該怎麼鋪陳、該在哪裡留下伏筆,但它明確不做兩件事。第一,它不撰寫任何一句會出現在成品中的正文,它交出的是規格,而不是文字本身。第二,它不查證任何技術細節的正確性,某個函式的參數是否過時、某段語法是否還能執行,這些查證工作不屬於規劃代理人的職責範圍,而是留給下游角色處理。規劃代理人的產出邏輯,與 Day 02 定案的產出優先思維完全一致,先定義好要交出什麼樣的規格,才輪到後續角色依規格展開。
寫作代理人:單一負責的認知任務,是依據規劃代理人交付的產出規格,展開成實際的文字段落與程式碼範例,並在撰寫過程中查證技術細節是否正確、是否過時。它站在工程師的位置,把規劃好的骨架填上血肉,同時對每一處具體的技術宣稱負起查證責任。但它明確不做兩件事。第一,它不自行決定文章的整體結構或段落順序該怎麼安排,這是規劃代理人已經決定好的範圍,寫作代理人只能依循,不能自己重新規劃全文邏輯。第二,它不負責產出圖表或視覺素材,遇到需要圖表輔助說明的地方,它只負責標示這裡需要一張什麼樣的圖,實際畫出來的工作不屬於它的職責。
視覺代理人:單一負責的認知任務,是依據文章內容產出輔助理解的視覺素材,例如架構圖、資料圖表、封面或插圖。它的輸入是已經存在的文字或數據,輸出是對應的視覺呈現。但它明確不做兩件事。第一,它不判斷文章的論述邏輯是否成立,一段論證是否站得住腳,不在它的判斷範圍內。第二,它不修改或補充正文的文字內容,即使它在畫圖過程中發現某段文字描述得不夠清楚,也不會擅自回頭改寫文字,這種回饋屬於審查代理人的職責。
審查代理人:單一負責的認知任務,是在成品產出後,扮演最嚴苛讀者的角色,對前面三者的產出進行查核,包含事實正確性、可讀性、格式一致性等面向。它站在挑剔讀者的位置,用最不留情面的眼光重新審視一遍整份成品。但它明確不做一件最關鍵的事,它不負責產出任何一段會直接沿用進成品的新內容。它的職責是找出問題並回饋,而不是動手重寫。發現問題之後,修正的執行權應該回到對應的上游角色,審查代理人本身不越界代勞。
四個角色攤開來看,會發現彼此的職責邊界剛好互不重疊,也沒有任何一種認知任務被同時交給兩個角色。這正是單一職責 Agent 原則收斂出來的自然結果,不是為了湊滿四個角色而刻意拆分。
角色定義清楚之後,下一個問題是這四個角色實際運作時,工作成果要怎麼從一個角色流向下一個角色。
規劃代理人是整條工作流的起點。它的產出是後續所有角色工作的依據,寫作代理人不會憑空自己決定今天要寫什麼,而是依照規劃代理人已經定案的產出規格展開。這個先後順序不能顛倒,如果寫作代理人在還沒有明確規格的情況下就開始動筆,等於又退回了 Day 02 描述的輸入優先思維,讓下游角色自己猜測該寫什麼重點。
寫作代理人與視覺代理人之間,關係比較特殊,是協同而非單純的先後接力。寫作代理人產出文字內容的過程中,視覺代理人可以依據已經成形的文字或數據內容,同步或隨後產出對應的視覺素材。兩者不必嚴格排隊等待對方完全做完才輪到自己動工,最終目標是把文字與圖表整合成一份圖文並茂的完整草稿。
審查代理人的介入時間點,在前面三者都已經產出實際成果之後,也就是文字草稿與視覺素材都已經存在、可供檢視的階段,審查代理人才開始工作,而不是在規劃或撰寫過程中途介入插手。這個時間點的安排也有它的道理,審查代理人扮演的是最嚴苛讀者的角色,讀者本來就應該是在作品完成之後才登場評判,而不是在創作者還在構思或動筆時就在旁邊指指點點。
審查代理人查出問題之後,修正的交接方向一律回頭指向對應的上游角色。內容層面的問題回頭交給寫作代理人,結構或規格層級的問題回頭交給規劃代理人,視覺呈現的問題回頭交給視覺代理人。審查代理人本身不動手修改,只負責標示問題與指出回饋去向,這也呼應了它「不產出任何會沿用進成品的新內容」這個職責邊界。
整條工作流串起來,會呈現出一種有先後順序但不僵化的樣貌,接近一條有明確交接點的生產線。規劃代理人先定案規格,寫作代理人依規格展開內容並與視覺代理人協同產出圖文,審查代理人最後把關,發現問題就把工作交還給對應的上游角色重新處理。這裡刻意不去描述交接時具體用什麼格式、什麼檔案、什麼方式傳遞,那些屬於後面才要處理的問題,今天只確立這個先後順序與交接方向本身。
四個角色的職責邊界與交接順序都講清楚之後,還有一件事沒有收尾。《Day 01:為什麼傳統的「一鍵生成」寫不出好的長篇技術文章?》 定案的四大致命傷,注意力稀釋、內容漂移、事實幻覺、零容錯結構,這四個問題現在有沒有被真正正視?
答案是肯定的,但對照關係不是機械式的一對一分配,而是主要負責搭配次要協助的雙軌結構。
| 致命傷 | 主要負責 | 次要協助 | 對應機制 |
|---|---|---|---|
| 注意力稀釋 | 寫作代理人 | 無 | 只承擔撰寫與查證這一種認知任務,宏觀結構已由規劃代理人事先決定,不必再來回切換兩種思考模式 |
| 內容漂移 | 規劃代理人 | 審查代理人 | 規劃代理人在產出規格階段先定義好每個單元的核心目標與前後銜接,審查代理人在成品產出後複核實際內容是否偏離規格 |
| 事實幻覺 | 寫作代理人 | 審查代理人 | 寫作代理人在撰寫過程中查證技術細節是否過時,審查代理人在成品完成後再做一輪複核,形成兩道防線 |
| 零容錯結構 | 規劃代理人 | 審查代理人 | 規劃代理人先把創作過程拆分成具備獨立邊界的產出規格與段落單元,審查代理人發現問題時只需精準指向對應段落與角色,不必要求整篇重寫 |
這張表格看起來像是清楚的分配表,但實際運作起來,四個病灶各自都有明確的責任歸屬與防線層次,並非每個角色只能解決一個病灶、彼此互不相干。注意力稀釋主要靠寫作代理人一個角色就能正視,因為問題的根源本來就是單一角色內部的認知負荷,拆分之後負荷自然下降。內容漂移與零容錯結構則需要規劃代理人在源頭先建立可校準、可拆分的結構,再由審查代理人在後端把關,形成前後呼應的兩端防線。事實幻覺的兩道防線最直白,撰寫時查一次,審查時再查一次,降低單一環節疏漏就直接流出成品的機率。
四大病灶提出的時候,看起來像是四個各自獨立、無法根治的架構性宿命。但拆解成四類角色分工之後會發現,每個病灶其實都有具體角色在對應的環節上正視它,不再是無人接手的空白地帶。這是階段一問題陳述真正被回應的時刻,也是今天這篇文章作為階段收尾最核心的任務。
今天正式揭曉了四類 Agent,規劃代理人、寫作代理人、視覺代理人、審查代理人,定義了各自的職責邊界與明確不做什麼,也說明了彼此交接工作成果的先後順序,並且把 Day 01 定案的四大病灶逐一對應回這四個角色,形成問題與解方的完整閉環。
但角色到位、交接順序講清楚,不代表實際運作時就能順利銜接。這裡浮現一個更根本的問題,規劃代理人交給寫作代理人的東西,具體要用什麼共同的格式或依據,才能讓寫作代理人明確知道該寫什麼、不該寫什麼?如果沒有一個雙方都認得的共同交接依據,交接關係說得再清楚,實際運作時依然可能各說各話,規劃代理人以為自己交代得夠明確,寫作代理人卻讀出完全不同的理解。
規劃代理人交給寫作代理人的東西,究竟要用什麼共同的格式或依據,才能讓下游角色明確知道該做什麼、不該做什麼,這個共享的地基還沒有名字、還沒有樣貌。這正是接下來要處理的問題,將在《Day 04:規劃代理人的產出介面,認識 Section Spec》正式揭曉。